ASP Advantage 1994 2nd Q2

home *** CD-ROM | disk | FTP | other *** search

/ ASP Advantage 1994 2nd Q2 / The Association of Shareware Professionals - The Official ASP Advantage (2nd Quarter)(1994).bin / files / utilfile / usemgr10 / usemgr.doc < prev next >

Wrap

Text File | 1993-04-02 | 44.8 KB | 1,117 lines

CONTENTS LIMITED WARRANTY, COMPATIBILITY and ACKNOWLEDGMENTS i REGARDING REGISTRATION AND TECHNICAL SUPPORT ii I THE USE MANAGER SYSTEM 1 II INSTALLATION 1 USETSR 2 USEMON 2 III GETTING AROUND IN USEMGR 3 Getting Around the Directory 3 IV USING THE MENU 4 The Files Submenu 4 Move 5 Change Dir 5 Copy 5 Delete 5 The Filter Submenu 6 Loading and Saving Named Filters 6 Changing the Startup Filter 7 The Sort Submenu 7 The Tools Submenu 8 Shell to DOS 8 Print 8 Custom Entries 8 The Options Submenu 10 Screen Lines 10 Delete and Overwrite 10 Setting Directory Display Colors 10 V HOUSEKEEPING FEATURES 11 USEMON Pack mode 11 USEMON Clear Mode 11 USEMON Subdirectory 11 USETSR Control Mode 11 USETSR Auto-Call Mode 11 Auto-Call under Windows or Desqview 12 Appendix A - Sample Configuration File 13 Appendix B - Keycodes 16 LIMITED WARRANTY XD Systems warrants the physical diskette enclosed herein to be free of defects in materials and workmanship for a period of 60 days from the date of purchase. In the event of notification within the warranty period of defects in material or workmanship, XD Systems will replace the defective diskette. XD Systems specifically disclaims all other warranties, express or implied, including but not limited to implied warranties of merchantability and fitness for a particular purpose. In no event shall XD Systems be liable for any loss of profit or any other commercial damage, including but not limited to special, incidental, consequential or other damages arising out of the use, the result of use, or inability to use this product. This program is produced by a member of the Association of Shareware Professionals (ASP). ASP wants to make sure that the shareware principle works for you. If you are unable to resolve a shareware-related problem with an ASP member by contacting the member directly, ASP may be able to help. The ASP Ombudsman can help you resolve a dispute or problem with an ASP member, but does not provide technical support for members' products. Please write to the ASP Ombudsman at 545 Grover Road, Muskegon, MI 49442-9427 or send a Compuserve message via E-mail to ASP Ombudsman, 70007,3536. The ombudsman may also be contacted by FAX by sending to the ASP FAX number: (616) 788-2765. In communication with the Ombudsman, please include a telephone number and/or a FAX number if possible. COMPATIBILITY Users of J.P. Software's powerful command interpreter, 4DOS(TM), will recognize the file name DESCRIPT.ION. Our use of the DESCRIPT.ION file is entirely compatible with 4DOS version 4.0, and with MS-DOS or PC-DOS, version 3.3 or higher. However, you should note the following caution: VERSIONS OF 4DOS(TM) EARLIER THAN 4.0, AND THE NDOS (TM) DISTRIBUTED WITH THE NORTON UTILITIES ARE NOT COMPATIBLE WITH USEMGR AND CAN DELETE FILE USAGE INFORMATION. USEMGR is compatible with multi-taskers, including Desqview(TM) and Microsoft Windows(R). It recognizes when it is operating in a multi-tasking environment and minimizes its use of machine resources when waiting for user input. ACKNOWLEDGMENTS USEMGR was written in BORLAND PASCAL, with the help of the Object Professional library by TurboPower Software. The installation program was written by Lincoln Beach Software and is entitled First Impression. Page i Regarding Registration and Technical Support USEMGR is ShareWare. The law requires that if you use this program, you must register and obtain a license for it. The registration fee is $40 plus postage and handling. A registration form is included in the file ORDER.FRM on this disk. USEMGR will print it for you, if you wish. US$ checks, VISA, Mastercard and Discover orders are accepted. Registered users will receive the latest version of the program and will be notified of upgrades to 4ZIP/4UNZIP as they are released. Online help is available through CompuServe, by E-Mail. Help is also available by mail. I will try to answer all letters within 48 hours. We will also respond, within limits, to questions from non-registered users who are evaluating the program. You may reach XD Systems through the following methods: Mail: Iram J. Weinstein XD Systems 1014 Shipman Lane McLean, VA 22101 Telephone: (703) 821-3215 CIS: 70741,3711 A shareware evaluation copy of the latest version of USEMGR can always be obtained on request from XD Systems. Please send $3 for postage and handling. Also, the following on-line sources will always have the latest version available for downloading: Compuserve; GO IBMSYS Library 1 Knightec BBS Orangeville, ONT 519-940-0007 The Consultant BBS New York NY 718-837-3236 The DataExchange BBS Leesville, LA 318-239-2122 The Break RBBS Dale City, VA 703-680-9269 703-551-0000 Attention to Details BBS Mira Loma CA 909-681-6221 The Twilight Zone Auburndale, WI 715-652-2758 Space BBS Menlo Park, CA 415-323-4398 Page ii I. THE USE MANAGER SYSTEM USEMGR is a new and powerful system for managing hard disks. For the first time, you can automatically determine which files your system accesses frequently, which it seldom uses, and which are just cluttering up your hard disks. This capability will help you regain control of your hard disks, and help you sort out the files you really use from among the myriad of files that modern applications like WINDOWS or EXCEL install, willy-nilly, on your hard disk. USEMGR provides support for deleting, archiving or backing up files that you don't need to have easily available based on a certain knowledge of how many times each file has been accessed and when the last access occurred. USEMGR obtains the information on file usage by installing a small program, USETSR, that operates in the background, observing your use of the PC and recording to a log file the names of all the files that you, or your applications programs, create or read. USEMGR processes this information to determine how many times each file on your hard drives has been accessed and the date of the last access. You can use this information to decide whether to delete files, back them up, or archive them with a compression utility. II. INSTALLATION Installation of USEMGR from either a floppy disk, or from a subdirectory of your hard disk requires only a few steps. Most of the installation is automatic. 1. If the disk that you have received or downloaded from a BBS is archived, for example USEMGR.ZIP, you must unarchive this file, using the appropriate program. Then follow step 2. 2. Put the disk into your disk drive and type a:install (or b:install, if the disk is in your b: drive). Then follow the instructions of the installation program. THIS INSTALLATION PROGRAM WILL NOT CHANGE ANY OF YOUR EXISTING FILES OR DIRECTORIES. 3. Some of the files on the disk are not absolutely necessary. You can delete the files you don't need later. The following files are required however, and must be together in the same subdirectory: USEMGR.CFG USETSR.EXE USEMON.EXE USEMGR.EXE USEMGR.OVR After completing the installation procedure, some additional steps are necesssary to start up the file usage counting process. USETSR.EXE makes a list of file openings as they occur on your system, USEMON.EXE analyzes this list and creates a record of the number of times each file has been opened. Finally USEMGR.EXE puts it all together for you. The installation steps for USETSR and USEMON are described below. USEMGR needs no special installation. Page 1 USETSR USETSR.EXE is the engine that drives the Use Manager System. It is a TSR (Terminate and Stay Resident) program that loads itself into memory and then watches as other programs are run from the command line and as they open data files or call other programs themselves. If you want to keep track of file usage regularly, place the following line in your autoexec.bat file, replacing d:\yourdir with the drive and directory where you installed the files: d:\yourdir\usetsr.exe [drive] .. [drive] .. [drive] If you don't specify any drives, only drive C will be monitored. If you specify drives, they all will be monitored. Each time a file is opened, USETSR notes the file name. When the system is otherwise idle, it writes this list to a temporary log file of its own. This temporary file will ordinarily be called USETSR.DTA and will be located in the root directory of the first drive that USETSR is monitoring. For example, if your autoexec.bat file contains USETSR D C E USETSR will be activated to monitor the C,D and E drives and will place the log file in D:\. If you want to change the file name, or relocate it, use the DOS SET command like this in your autoexec.bat file: SET USETSRLOG=d:\yourdir\yourfile.ext You can put the logfile anywhere you want, including a Ram Disk, and give it any name you want, by setting the environment variable USETSRLOG. For example, from the DOS command line, or in the autoexec.bat file SET USETSRLOG=J:\XDSYS\USELOG USEMON USEMON.EXE is a utility program that serves several functions. When called with no command line options, it processes the file usage data, counts the number of times that each file has been used since it was last called, and adds this to the total for the file. It also tags this record with the last date on which the file was used. This information is stored in small files named DESCRIPT.ION. A descript.ion file will exist in each directory that contains file usage data. This is a hidden file that you will not see in the DOS DIR display. You should call USEMON whenever convenient. The usage information in the log file is not available for analysis until you do so. For most users, it is probably a good idea to put USEMON in the autoexec.bat file so that the log file from the previous session is automatically processed. That's all there is to the installation process. For convenience, you may also want to add the name of the subdirectory containing the Use Manager files into the path statement in your autoexec.bat file. Page 2 III. GETTING AROUND IN USEMGR USEMGR displays consist of three parts (Fig. 1) . The main portion of the screen contains a directory display. On the top row of the screen is a menu for controlling the program. The bottom row of the screen displays prompts, help information and other messages. [Figure 1 - The UseMgr Display] When USEMGR starts up, the directory display is active. If a mouse is detected, a cursor will be visible on the screen. At other times, the menu will be active; one of the menu items will be highlighted and a submenu may be displayed. When the directory display is active, the bottom row of the screen shows the number of files that have been selected, the total number of bytes they contain, and the name of the current directory. The directory contains the usual DOS information, and file descriptions if you have added them.[You can attach a file description as long as 120 characters to each file. See the discussion of 4EDIT.] [Figure 2 - The Two Directory Displays] The TAB key toggles the display, replacing the file description with the number of times each file has been accessed, the date of the last access and the file attributes, as shown in Figure 2. Getting Around the Directory Typically, you will want to select a number of files and then go to the menu to tell USEMGR what to do with them. In most cases, more than one way is provided to accomplish an action. This is done to accommodate people who want to use the older WordStar key patterns as well as those who are more comfortable with the IBM keyboard. The following keys and mouse actions can be used to maneuver around the directory display, and to mark selected files: For example, the first entry below means you can either press the HOME key, or press the CTRL and Q keys simultaneously, followed by the S key. <Home>, <CtrlQ><S> <End>, <CtrlQ><D> Highlight to first item. Highlight to last item. <Up>, <CtrlE>, <CtrlW> <Down>, <CtrlX>, <CtrlZ> Highlight up one row. Cursor down one row. <PgUp>, <CtrlR> <PgDn>, <CtrlC> Scroll display up one page. Scroll display down one page. <Ins> <Del>, <-> Mark the current item selected. Deselect the current item <Space>, <+> <CtrlEnter>, <CtrlJ>, <*> If the current item is not selected, If any items are select it; otherwise, deselect it. currently selected, clear all selections. If no items are currently selected, mark all items selected. Page 3 <CtrlK><H> <Enter> Deselect all items. Accept the current set of selections and exit the list. <F7>, <CtrlK><B> <F8>, <CtrlK><K> Make the currently highlighted item If a marked block has been started, the first one in a marked block. and the currently highlighted item is beyond the beginning point, all items in the block are marked. <ClickLeft> <Esc>, <ClickRight> Move the highlight bar to the Quit processing the list position indicated by the mouse. without making a selection. If the highlight bar is over the indicated item, toggle its selection. You can activate the menu at any time by pressing ESC or F10. Also, note that each menu item has a highlighted letter. Pressing the Alt key and one of these letters at the same time will activate the menu and pull down the selected submenu. These hot-keys are always available. If you have a mouse, you can pull down any of the submenus at any time by clicking the left button with the mouse cursor positioned in the menu item you want. When a menu action completes, USEMGR always activates the directory display again, and updates it if necessary. If the menu is active and you want to regain access to the directory display without completing a menu action, just press ESC or F10 or click both the left and right mouse buttons at the same time. IV. USING THE MENU The Files Submenu [Figure 3 -The Files Menu] Now suppose you have marked a number of files that are not used very often. These are files that you probably don't need. If you are sure, then delete them right now. If you think that some application might want one of these files, then a good alternative is to create a subdirectory under the current directory (I call mine NOTUSED), move the files there, and then wait and see. If they haven't been needed after a reasonable time, then you can delete them. To DELETE or MOVE the marked files, call up the Files Submenu. You can do this several ways: Type ESC or F10 to enter the menu, use left or right arrow to position to Files and press Enter. Type ESC or F10 to enter the menu, then press the highlighted letter in the submenu you want to activate (in this case, F). Move the mouse cursor to the word Files in the menu and press the left mouse button. Page 4 Type The Alt key and the highlighted letter in Files simultaneously (Alt-F) These same techniques can be used throughout the menu system. When the Files Submenu pops down, you can select the Move function by pressing the highlighted letter M, or use the up or down arrow keys to position the highlight to Move, then press Enter, or use the mouse to Left Click on the word Move. Figure 3 shows the Files Submenu. Move When you select Move, USEMGR will request the destination. In the example here, you would enter NOTUSED\ to show that you want the files moved to the NOTUSED subdirectory under the current directory. If the directory NOTUSED does not exist, USEMGR will ask permission and then create it for you. Be sure to include the \ symbol to show that NOTUSED is a directory, not a file name. Note that the Move function can also be used to rename files. For instance, if you wanted to change the extension on a bunch of spreadsheets from WKS to OLD, you could do this by entering *.OLD when USEMGR asks for the destination. The Rename and Move actions can be combined. A destination of NOTUSED\*.OLD would move all the marked files to the NOTUSED directory and also change their extensions to OLD. Change Dir [Figure 4 - Change Dir Window] To change directories, select the Change Dir function in the Files submenu. A directory menu pops down as shown in Figure 4. Subdirectories of C:\WINDOWS are shown. You could back up the directory tree by selecting ..\, or switch to one of the other drives by selecting the drive letter, for example [A:]. When you've picked the one you want, type Ctrl-Enter, or click on the box in the lower corner of the window. Copy The COPY function works just like Move. USEMGR will prompt for a destination, and again, the files can be renamed as they are copied. By default, USEMGR will ask permission before copying if a file with the same name exists in the destination directory. Delete The Delete function will delete all the marked files. By default, USEMGR will display the message: You have requested deletion of xx files. Proceed? OK Cancel If you select Cancel, the files will not be deleted, but they will still be marked so you can do something else with them if you wish. Page 5 The Filter Submenu [Figure 5 - Filter Submenu] When searching through a large directory for files that are not used very often, you might wish that only these files were displayed. The filter submenu allows very flexible control over the choice of files to display. It allows you to select files by their names, creation date, size, attributes, number of uses and use dates. A group of rules like this for selecting files is called a filter. You can give a filter a name, and recall it for later use. To move from field to field in the submenu, use the Tab key (Shift-Tab to go backwards) or click in the field with the mouse. When you get to a field that you want to change, type in the changed value. The Filter editor will check your entry and will beep if it is not valid. The file include list is especially powerful, with some unusual features. You can enter several filespecs in the list. For example, *.wks *.xls would display all files that had either the wks or xls extension. Any number of filespecs can be used, up to a maximum of 40 characters. The wildcard symbol '*' means "zero or more characters in this position". This is more powerful than the normal DOS usage. For example, you can type jan*.mem to display all your memo files that start with JAN, but you also can type *jan*.mem to display the memo files with JAN anywhere in the name. When you have adjusted the filter rules as you want them, you can activate it, and leave the filter menu by typing CTRL-ENTER or clicking the mouse left button in the region at the bottom of the menu marked ^Enter When Done. If you decide that you don't want any of the changes you've made, you can exit by pressing ESC or clicking the mouse right button. Loading and Saving Named Filters The last two fields in the Filter Submenu are called "Load Filter" and "Save Filter". When you are positioned into one of these fields, a list drops down showing the existing named fields. Figure 5 shows the "Load Filter" list. These filters are stored in the file USEMGR.CFG. There is also a filter named BUILT-IN that is contained within the USEMGR program. Several filters are present at installation. You can add to these or modify them at any time. The pre-installed filters are: BUILT-IN - This filter displays all files, with the exception of hidden or system files. NOT USED - This filter displays only files that have not been used at all since the USEMGR system was installed on your system. It is useful for finding files that you can remove from the hard disk, or archive. OFTEN USED - This filter displays only files that have recorded at least 25 uses since USEMGR was installed. Page 6 MISC JUNK - This filter displays files with names *.bak *.tmp *.$$$ *.jnk junk*.* These file names indicate that they are no longer needed and are likely candidates to be deleted. To save a filter, select the Save Filter field. A list will drop down that shows the existing filters and also the entry New Name. If you want to save the current filter with one of the existing names, just select the name and press Enter, or double click on the name with the left mouse button. To save the filter under a new name, select New Name. An entry window will open and you can type in any name you want, up to 15 characters including spaces between words. When a filter is saved, the current Sort method is saved with it. So if you want to change the Sort method associated with a filter, change the Sort, and then resave the filter. At any time, you can recall one of the previously named filters by selecting Load Filter, and then selecting the named filter you want. When you press Ctrl-Enter to leave the filter menu, the new filter will become active. To delete a filter from the system, move the highlight over it in either Load Filter or Save Filter, and press Alt-D or DEL. Of course, the Built-In filter cannot be deleted. Changing the Startup Filter At startup, USEMGR looks in the USEMGR.CFG file for a filter named DEFAULT. If it doesn't find DEFAULT, then the filter is set to the BUILT-IN filter, which was shown in Fig. 5. If you want to start USEMGR with a different filter, you can specify it on the command line. A couple of examples are shown below. USEMGR /fworksheets USEMGR /f"misc junk" You can use upper or lower case here, but note that the filter name must be surrounded with " " if it contains any spaces. The Sort Submenu [Figure 6 - The Sort Submenu] The file display can be sorted by any of eight methods that are selected from the Sort submenu, which is shown in Figure 6. The submenu shows that the files are currently sorted by Extension. To select a different sort method, move the highlight to the desired method and press Enter, or double click on the desired method with the left mouse button. The current sort method is saved when you save a filter. If you want to change the sort method associated with a filter, select that filter, then change the sort method, and finally save the filter. To change the sort method that USEMGR uses at startup, apply this technique with the Default filter. Page 7 The Tools Submenu [Figure 7 - The Tools Submenu] This submenu is one of the most powerful, and the most flexible, of the USEMGR menus. It is designed so that you can add your favorite tools to the menu easily. The Tool menu allows the automatic submission of highlighted or marked files to be processed by external programs of your choice. Shell to DOS The first entry on the menu is Shell to DOS. When this entry is selected, USEMGR saves itself in memory and gives you access to the DOS prompt, where you can run any program you want, within the available memory, which will be about 6K less than available without UseMgr. The function key F2 will activate the DOS shell at any time, except when the filter submenu is displayed. Print The Print entry will appear on the Tools Submenu only if you have installed the DOS PRINT spooler before running UseMgr and are running DOS 3.0 or higher. Selecting Print will cause the marked files to be printed in the background. Control will be returned to UseMgr immediately. USEMGR applies a few safety checks of its own before submitting the files. Normally, only text files can be printed. USEMGR will not send to the printer files whose extensions indicate that they will be unprintable. These extensions include exe, com, bin, tpu, obj, zip, arc, arj, pak, wks, xls and xlc. If your printer is not ready, USEMGR will display an error message and clear the print queue. When you have made the printer ready, reselect the files and resubmit them to Print. If Print does not appear on the menu and you want to use this tool, exit from USEMGR and type print at the command line. DOS will respond with Name of list device [PRN]: In most cases, all you need to do at this point is press the Enter key, and Print is then installed. However, Print does have a large number of options. You may need to consult your DOS manual. Custom Entries The two entries just discussed are the only ones that are pre-installed in USEMGR. The others shown in Fig. 7 are all custom entries controlled by USEMGR.CFG. You may need tp modify these menu entries to make them work and can install others yourself by editing the USEMGR.CFG file. The full details of the mysteries of editing USEMGR.CFG are discussed in Appendix A. For now, we'll talk about how you can customize any of the entries in Fig. 7 to your tools list. Page 8 Since USEMGR Tools apply external programs to your files, you must have the programs available on your machine. The menu shown in Fig. 7 is set up for the following programs: ZIP - PKZIP by PKWare and 4ZIP by XD Systems -- Archive all marked files. UNZIP - PKUNZIP by PKWare and 4UNZIP by XD Systems -- Display directory of highlighted ZIP file. Select files to be unzipped. LIST - LIST by Vernon D. Buerg -- Browse through the highlighted file. EDIT - Text editor included with DOS 5 - Add or change description of highlighted file. 4EDIT - 4EDIT, a description editor by XD Systems - Add or change description of highlighted file. {Version 1.12 of 4EDIT will support batch editing of descriptions of all marked files. Read USEMGR.NOT on the 4EDIT disk.} Shareware evaluation copies of the XD Systems programs 4ZIP, 4UNZIP and 4EDIT are generally available on BBSes, Compuserve IBMAPP Lib 1, or can always be obtained on request from XD Systems. Please send $3 for postage and handling. The TOOLS menu can access them if you install them in any directory that is included in the DOS PATH statement. The method for changing any of these is the same, involving modifying the USEMGR.CFG file with a text editor. But first, make a backup copy, in case you make a mistake. COPY USEMGR.CFG USEMGR.SAV Now, load USEMGR.CFG into your text editor. If you are running DOS 5, the command would be: EDIT USEMGR.CFG Scroll through the editor until you find the following in the section with the heading [TOOLS] KEY=ZIP F3,4zip -ac @\@\ %2,3d00,ZIP marked files.Prompts ... KEY=UNZIP SH- F3,4unzip.exe,5600,Unzip current file,1,YES KEY=LIST F4,list.com,3E00,View File as Text or Hex,1,NO KEY=EDIT SH-F4,edit,5700,Edit ASCII text file,1,NO KEY=4EDIT F5,4edit.exe,3F00,Edit file description,1,NO These are the entries that insert new tools into the tools menu. If you want to remove any entry from the menu, just insert a semicolon at the beginning of its line. The semicolon turns the line into a comment that UseMgr ignores. If you have a different file browser other than LIST, or if you prefer a different text editor than EDIT, just insert the name of your program appropriately. For example, you might change the LIST entry from: KEY=LIST F4,list.com,3E00,View File as Text or Hex,1,NO to KEY=BROWSE F4,browse.exe,3E00,View File as Text or Hex,1,NO Page 9 UseMgr will search for the specified program along the DOS path. If the program is not on the path, put the full path and name in UseMgr.Cfg. Feel free to experiment with the USEMGR.CFG file. USEMGR will make the changes and tell you if it finds a syntax error in the file the next time you run it. In any case, you can always get back to the file you started with as follows: COPY USEMGR.SAV USEMGR.CFG The Options Submenu [Figure 8 - The Options Submenu] Screen Lines This submenu offers a few choices for USEMGR behavior. The first group sets the number of lines on the screen. If you have an EGA or VGA monitor, you can select the 43/50 Line Screen entry. This will change the screen to 43 lines on the EGA monitor and 50 lines on the VGA. If you want USEMGR to start in this mode, select Save. USEMGR will then modify the appropriate entry in the USEMGR.CFG file. When USEMGR exits, it always restores the display to the mode it was in on entry. There are several special text modes available on VGA monitors. One of the most popular of the utilities used to set up these special modes is UltraVision(TM) by Personics. When UseMgr starts up, it tests for the presence of UltraVison, and adapts its behavior to it. If Ultravison has installed a screen width larger than 80 characters wide, USEMGR will use the full width. If Ultravision has set up a nonstandard screen height, USEMGR will use this height if the user selects the 43/50 Line Screen from the Options menu. Delete and Overwrite The entries in the second group on the Options menu control whether USEMGR will ask you for verification when you request the deletion of a set of files, or when a Copy or Move operation will result in overwriting a file in the destination directory. Both of these default to ON. You can turn them off just for one session, or by selecting Save, you can change the default behavior. Setting Directory Display Colors USEMGR can distinguish between four different groups of files, and will display the directory entries for each group in a different color. To specify the filespecs to be associated with each group, you must edit the USEMGR.CFG file. The procedure is similar to the one described above for Tools. Look in USEMGR.CFG in the section with the heading [OPTIONS] until you find the following: ;1FileGroup=*.exe ; Color Red ;2FileGroup=*.wks *.xls ; Color Brown ;3FileGroup=*.bak *.tmp *.jnk ; Color Lt. Cyan Page 10 Note that only three file groups are entered here. The fourth group is the group of all files not otherwise mentioned. Remove the semicolon in front of each group you want to activate, and change the filespecs as you want them. The rules for filespecs here are the same as they are in the Filter submenu. If a file belongs to more than one file group, it will be colored according to the last group it matches. V. HOUSEKEEPING FEATURES USEMON and USETSR have some housekeeping modes, selected by command line switches. USEMON Pack mode - /P [d:]path Pack the DESCRIPT.ION file in the specified path to delete entries referring to files that no longer exist. Usemon Clear Mode - /C [d:]path Clear Use Data from all entries in the DESCRIPT.ION file on the specified path. Usemon Subdirectory switch - /S If /P or /D has been specified, process all subdirectories of the specified path. Usetsr Control Mode OFF|ON There are times when you won't want USETSR to faithfully log all file access. For example, you may use a utility like WHEREIS to search all your ZIP files for a file, or GREP to search all the DOC files for a phrase. USETSR would record an access to each of these files. To prevent this, execute USEMON OFF your program USEMON ON Usetsr Auto-Call Mode USETSR can be installed to call USEMON automatically whenever your PC is idle for a period you can specify. This feature helps insure that usage data is updated regularly, and is especially important if the log file is being kept on a Ramdisk. Otherwise, it is all too easy to lose usage data if you forget to call USEMON before turning off the machine. To implement the Auto-Call mode, just insert the number of minutes you want USETSR to wait as the first parameter on the command line when you install USETSR . An example is: USETSR 15 C D E Page 11 Auto-Call under Windows or Desqview The USETSR auto-call mode dows not work under these multi-taskers. The best way to obtain the same effect is to open a small DOS window and run the utility program REPEAT.EXE, which is supplied on the distribution disk. The setup looks like this: REPEAT nn USEMON where nn is the desired repetition interval in minutes. REPEAT will run in this window in the background, calling USEMGR automatically every nn minutes. A Windows PIF file is included that will set all this up for you just by installing it into the Windows 3.1 Startup Group. This PIF file assumes that you have copied REPEAT.EXE into the directory C:\USEMGR. If the file is in a different directory, or if you want to change the repetition interval, you will need to modify REPEAT.PIF using the Windows PIF Editor. Page 12 Appendix A -Sample Configuration File The file USEMGR.SMP is a sample configuration file for USEMGR that you can use as is, or study to see how the configuration file is put together as it is heavily documented with comments. A listing of this file is provided in this appendix for convenience. ;SAMPLE USEMGR CONFIGURATION FILE - NOVEMBER 8, 1992 ; This sample file is provided to explain how the USEMGR configuration file is ; constructed and to show how to make additions and changes to it. ; ; The USEMGR.CFG file is used by both USEMGR and USEMON to set up values of ; the program parameters. Most entries in the file are maintained by USEMGR ; itself, and users do not ordinarily need to worry about them. But some ; entries can only be made or changed by modifying this file directly. Any ; standard ASCII text editor can be used. ; When USEMGR reads its configuration file, it ignores all blank lines, and ; all text following a semicolon. Comments can be placed anywhere in the file, ; but remember that when USEMGR rewrites a section of the file it will delete ; the comments in that section. ; The file is divided into sections headed by a section name such as [OPTIONS] ; or [TOOLS]. The section name must be enclosed in brackets, and may contain ; multiple words up to a total of 15 characters. USEMGR and USEMON ignore case ; in section names. A section continues until the next section name or the end ; of the file is reached. ;----------------------------------------------------------------------------- ; The [OPTIONS] section is used by USEMGR to set the startup condition for the ; number of lines on the screen (requires EGA or better monitor). It also ; determines the extent to which USEMGR will ask for confirmation before ; deleting or overwriting files. These items can be changed within USEMGR in the ; OPTIONS menu. The change can be made permanent by selecting OPTIONS SAVE ; The next three items allow three groups of file types to be displayed in ; distinctive colors in the USEMGR directory display. The examples show ; typical uses. These entries must be made with an editor. The color choices ; are fixed, and cannot be changed by the user. ;----------------------------------------------------------------------------- ; The [TOOLS] section defines the way in which user-supplied programs are ; accessed from USEMGR. These programs will appear in the USEMGR TOOLS menu ; and can act on either the highlighted file, or on all of the marked files. ; This is the most flexible, but complicated, part of the USEMGR.CFG file. ; All changes and additions to this section must be made with an editor. ; Each Tool is defined on a single line that has the following form: ; KEY=MENU ENTRY, COMMAND,KEYCODE,STATUS,SCOPE,EDIT ; Menu Entry - Text you want to appear in the Tools menu ; Command (Including default parameters) ; KeyCode is the code that defines the hot key for this entry. See the Appendix ; in the USEMGR manual. Page 13 ;Status String is the Help entry that will appear on the bottom of the screen ;Scope: 1=Apply command to highlighted file ; 2=Apply command sequentially to all marked files ; 3=Create a list of marked files and insert filename where indicated ; by @\xxxxxx\ ;Edit YES=Allow user to edit command before execution ; NO=Execute command immediately. ;Menu, Command and Key are required. ;Defaults will be used for the others if not present. ;However, the comma delimiters are always required. ;Use %1 to indicate where in the command you want the filename inserted. ;The default for %1 is at the end of the command ;Use %2 to indicate where you want user-supplied options to be inserted. ;Usemgr will open an edit window to get the options, and will insert them ;there. The default is No user supplied options. ;Use @\xxxxxx\ to have UseMgr supply a list of marked files for use by your ;program. UseMgr will insert filename where indicated by @\xxxxxx\ ;Example Myprog @\<\ results in Myprog <usemgr.tmp ;----------------------------------------------------------------------------- ; When you save a filter in USEMGR, it writes a section in the USEMGR.CFG file ; with the name of the filter, defining each of the selection criteria in the ; filter. Since USEMGR will do this automatically, and has built-in error ; checking that will prevent inconsistent filter criteria, you probably will not ; need to create your own. But for completeness, here are the key words ; involved, using the default values as an example. NOTE that if any of ; these entries are not present, USEMGR will use the default values. ; You can have as many different filter entries as you want. ; [EXAMPLE] ; Filter Name ;Files=*.* ;File specs to be displayed. Default is '*.*' ;MinCreateDate=01-01-1900 ; Earliest File Creation Date ;MaxCreateDate=12-31-2100 ; Latest File Creation Date ;MinSize=0 ; Don't show files smaller than this. ;MaxSize=32000000 ; Don't show files larger than this. ;Hidden=NO ; Don't show Hidden files. ;SysFile=NO ; Don't show System files. ;MinUses=0 ; Don't show files with fewer uses. ;MaxUses=999999 ; Don't show files with more uses. ;MinDateUsed=01-01-1900 ; Don't Show files last used before this. ;MaxDateUsed=12-31-2100 ; Don't Show files last used after this. ;Sort=NAME ; Sort display by name ;----------------------------------------------------------------------------- ; USEMON also uses the USEMGR.CFG file to specify the files for which it will, ; and will not process usage data. These sections are [SELECT] and [REJECT]. ; An entry in either section can be one of three types, examples of which are ; shown below; Page 14 ; [REJECT] ; *.bak ; Don't count usage for any file with extension BAK ; c:\letters\*.old ; Don't count usage for files in c:\letters subdirectory ; with extension OLD ; c:\test\*.* /S ; Don't count usage for ANY file in c:\test or ; any of its subdirectories. ; The same syntax applies to the [SELECT] section, although the most likely ; entry there is *.* ;----------------------------------------------------------------------------- [OPTIONS] VGA25=YES ;Start USEMGR with 25 line screen ;VGA25=NO ;Start USEMGR with 43/50 line screen DeleteQuery=YES ;Ask user to confirm before deleting files ;DeleteQuery=NO ;Delete files without confirmation OverWriteQuery=YES ;Ask user to confirm before overwriting existing file. ;OverWriteQuery=NO ;Overwrite existing file without confirmation. ;1FileGroup=*.exe ;Color Red ;2FileGroup=project*.wks *.xls ;Color Brown ;3FileGroup=*.bak *.tmp *.jnk ;Color Lt. Cyan [TOOLS] ;KEY=ZIP F3,4zip -ac @\@\ %2,3d00,ZIP marked files. Prompts for ZIP file name and options.,3,No ;KEY=UNZIP SH-F3,4unzip.exe,5600,Unzip current file,1,YES ;KEY=LIST F4,list.com,3E00,View File as Text or Hex,1,NO ;KEY=EDIT SH-F4,edit,5700,Edit ASCII text file,1,NO ;KEY=4EDIT F5,4edit.exe,3F00,Edit file description,1,NO [MISC JUNK] Files=*.bak *.tmp *.$$$ *.jnk junk*.* MinCreateDate=01-01-1900 MaxCreateDate=12-31-2100 MinSize=0 MaxSize=32000000 Hidden=NO SysFile=NO MinUses=0 MaxUses=999999 MinDateUsed=01-01-1900 MaxDateUsed=12-31-2100 Sort=NAME [OFTEN USED] Files=*.* MinCreateDate=01-01-1900 MaxCreateDate=12-31-2100 MinSize=0 MaxSize=32000000 Hidden=NO Page 14 SysFile=NO MinUses=25 MaxUses=999999 MinDateUsed=01-01-1900 MaxDateUsed=12-31-2100 Sort=NAME [DEFAULT] Files=*.* MinCreateDate=01-01-1900 MaxCreateDate=12-31-2100 MinSize=0 MaxSize=32000000 Hidden=NO SysFile=NO MinUses=0 MaxUses=999999 MinDateUsed=01-01-1900 MaxDateUsed=12-31-2100 Sort=EXTENSION [NOT USED] Files=*.* MinCreateDate=01-01-1900 MaxCreateDate=12-31-2100 MinSize=0 MaxSize=32000000 Hidden=NO SysFile=NO MinUses=0 MaxUses=999999 MinDateUsed=01-01-1900 MaxDateUsed=12-31-2100 Sort=EXTENSION [SELECT] *.* [REJECT] *.$$$ *.tmp *.bak *.swp Page 15 Appendix B - Keycodes The function key keycodes needed in the tools section of the configuration file are listed here. Key Normal Shift Ctrl Alt F1 3B00 5400 5E00 6800 F2 3C00 5500 5F00 6900 F3 3D00 5600 6000 6A00 F4 3E00 5700 6100 6B00 F5 3F00 5800 6200 6C00 F6 4000 5900 6300 6D00 F7 4100 5A00 6400 6E00 F8 4200 5B00 6500 6F00 F9 4300 5C00 6600 7000 F10 4400 5D00 6700 7100 F11 8500 8700 8900 8B00 F12 8600 8800 8A00 8C00 Page 16